home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #11 / Amiga Plus CD - 2004 - No. 11.iso / AmiSoft / Dev / cross / DiStella.readme < prev    next >
Text File  |  2004-09-23  |  2KB  |  66 lines
  1. Short:    A disassembler specifically created for the Atari 2600 and 7800
  2. Author:   John K. Harvey (jkharvey@voyager.net). Amiga port by Voy/SSG^Dial^SWAT
  3. Uploader: Wojciech Pasiecznik/Voy/SSG^Dial^SWAT (voydial@wp.pl)
  4. Version:  3.00
  5. Type:     dev/cross
  6. Requires: MC68000+
  7.  
  8. Distella is a disassembler specifically for the Atari 2600.  Since its
  9. creation, it has been modified to disassemble Atari 7800 code as well. It
  10. creates source code that is usually recompilable without any human
  11. intervention. It examines the code and performs some basic tracing routines
  12. which allow it to accurately distinguish data from code.
  13.  
  14. Features:
  15.  
  16.  - Written in portable ANSI C - source code is included.
  17.  - Very fast
  18.  - Distinguishes data from code
  19.  - Uses labels for Atari 2600/7800 register locations
  20.  - Allows user to override or disable auto data determination
  21.  - Optionally includes 6502 cycle times as comments
  22.  - Freeware - Use it, Love it, Live it!
  23.  
  24. Command format:
  25.  
  26.   Distella [options] romimage [> sourcefile]
  27.  
  28. Distella puts the sourcecode generated to standard output, so to put it
  29. in a file, use the '>' redirection.  Unlike Distella 1.0, the .bin suffix
  30. is not assumed, and you must use the -c flag to tell DiStella the name
  31. of a config file if you choose to use one.
  32.  
  33.   Options:
  34.  
  35.    -7  Use Atari 7800 MARIA equates and file sizes
  36.    -a  Turns 'A' off in accumulator instructions
  37.    -c  Defines optional config file to use.  (e.g. -cpacman.cfg)
  38.          (see distella.txt for additional information)
  39.    -d  Disables automatic code determination
  40.    -f  Forces correct address length
  41.    -i  Process DMA interrupt Vector (7800 mode)
  42.        If 2600 mode, enables -b option
  43.    -b  Process BRK interrupt Vector (2600 and 7800 mode)
  44.    -k  Enable POKEY equates (7800 mode only, auto-detected if a78 file)
  45.    -o# ORG variation: # = 1- ORG $XXXX  2- *=$XXXX  3- .OR $XXXX
  46.    -p  Insert psuedo-mnemonic 'processor 6502'
  47.    -r  Relocate calls out of address range
  48.    -s  Cycle count
  49.  
  50.  Examples: DiStella -pafs pacman.bin >pacman.s
  51.            DiStella -paf7ikscball.cfg ballblaz.bin >ballblaz.asm
  52.  
  53.  
  54. Authors:
  55.  
  56.    Bob Colbert    - rcolbert@novia.net
  57.                     http://www.atari2600collector.com
  58.  
  59.    Dan Boris      - dboris@comcast.net
  60.                     http://www.atarihq.com/danb
  61.  
  62. For version 3.0 and Atari 7800-related errors, contact:
  63.  
  64.    John K. Harvey - jkharvey@voyager.net
  65.                     http://www.cs.wisc.edu/~harvey/7800/
  66.